home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 1 / Precision Software Applications Silver Collection Volume One (PSM) (1993).iso / tutor / vocab02.arj / VOCAB.DOC < prev    next >
Text File  |  1993-02-12  |  13KB  |  352 lines

  1.             V O C A B U L A R Y    T U T O R
  2.             --------------------------------
  3.                First Release, Version 0.2
  4.  
  5.                Copyright 1993, Jack Lynch
  6.  
  7.  
  8. The Vocabulary Tutor is a simple freeware program for
  9. vocabulary drills.  This program may be distributed freely.
  10.  
  11. Running the program should be straightforward enough.  It
  12. requires little memory and disk space, and should run on any
  13. fully IBM-compatible system with even minimal RAM.  A hard
  14. drive is optional.
  15.  
  16. The program now comes with four supplementary vocabulary
  17. files, each with the extension .VOC:  FRENCH.VOC,
  18. FRENCH2.VOC, LATIN.VOC, and VERBS.VOC.  (This last concerns
  19. conjugating Latin verbs:  see the end of this document for
  20. details.)
  21.  
  22. To install the program, copy the VOCAB.EXE file and
  23. the relevant .VOC files into the same subdirectory.
  24.  
  25. To run the program, go to the DOS prompt, switch to the
  26. subdirectory containing VOCAB.EXE and the .VOC files, and
  27. type VOCAB followed by the name of the vocabulary .VOC file
  28. you want to use.  The .VOC extension is optional.  So, for
  29. instace, you can type either
  30.  
  31.     VOCAB LATIN
  32.  
  33. or
  34.  
  35.     VOCAB LATIN.VOC
  36.  
  37. to start the program with the LATIN.VOC vocabulary file.
  38. You can spell out a full path for the VOC file.
  39.  
  40.  
  41.  
  42. THE MAIN MENU
  43. -------------
  44.  
  45. The menu gives you six options, each of which is discussed
  46. briefly below.
  47.  
  48.  
  49.     1.  Limit Word List.
  50.  
  51.         Use this option to restrict the number of words
  52.         you're working with in one session.  There are three
  53.         ways to limit the number of words:  you can specify
  54.         a number of words from 1 to 100, and the program
  55.         will randomly select that many words; if the
  56.         vocabulary .VOC file contains chapter information,
  57.         you can restrict the words to the contents of
  58.         certain chapters; or you can work with only words
  59.         containing a certain pattern of letters (for
  60.         instance, IRE can find all -ire verbs).
  61.  
  62.         The chapter function is now implemented only in the
  63.         LATIN.VOC file, which is keyed to the chapters in
  64.         Frederic Wheelock's _Latin_.  Not all the words in
  65.         LATIN.VOC appear in Wheelock, nor are all of
  66.         Wheelock's words in LATIN.VOC; those that do,
  67.         however, include the chapter information.  The other
  68.         .VOC files do not yet contain any chapter
  69.         information.
  70.  
  71.  
  72.     2.  Review Words.
  73.  
  74.         Use this option to page through the selected words
  75.         and their definitions one by one before you begin a
  76.         quiz.  If you are working with the entire word list,
  77.         the words appear in random order; if you are working
  78.         with a limited word list (Option 1 above), you can
  79.         go forward and backward through the list.
  80.  
  81.  
  82.     3.  Quiz...
  83.     
  84.         This is the heart of the program, and has four
  85.         possible formats, selected on the next menu:
  86.  
  87.             English to Foreign Language,
  88.             Foreign Language to English,
  89.             Random English and Foreign Language, and
  90.             Review Mistakes.
  91.  
  92.         The first three are self-explanatory.  The fourth
  93.         option, Review Mistakes, will will quiz you on the
  94.         words you got wrong earlier in a session.  This is a
  95.         good way to brush up on your weak spots.
  96.  
  97.         In the quiz, answer checking is very lenient -- if
  98.         the translation in the .VOC file contains the
  99.         characters you typed, your answer will be counted
  100.         correct.  So, for instance, the Latin term
  101.  
  102.             valeo, valere, valui, -iturus
  103.  
  104.         is defined in the .VOC file as
  105.  
  106.             be strong, have power, be well.
  107.  
  108.         If in the quiz you define "valeo" as "well," the
  109.         program will accept the answer, even though it's
  110.         wrong, because the phrase "be well" appears in it.
  111.         (This makes it easy to cheat, by including as few
  112.         letters as possible.)
  113.  
  114.         It is therefore very possible for you to enter an
  115.         incorrect answer and have the program consider it
  116.         correct.  It is also possible to enter a correct
  117.         answer and have the program consider it incorrect:
  118.         if, for instance, you define "valeo" as "be
  119.         healthy," the program will count it wrong, because
  120.         that phrase does not appear in the definition.
  121.  
  122.         Another place for easy mistakes:  diacritical marks
  123.         such as accents and ligatures.  See below for Option
  124.         10 and Special Characters for information on typing
  125.         special characters.
  126.  
  127.         It's also worth noting that the .VOC files were
  128.         typed by hand, and could well contain typos or
  129.         inaccuracies.  If you discover any, you can correct
  130.         them yourself with a text editor (see below for the
  131.         format of the .VOC file).  Feel free to contact Jack
  132.         Lynch with corrections; the address appears above
  133.         the menu.
  134.  
  135.         For these reasons, take the percent-correct
  136.         indicator only as a rough guide.  To increase your
  137.         chance of being graded correctly, enter only a one-
  138.         or two-word definition:  don't try to match a long
  139.         definition exactly.  For "valeo," for instance, "be
  140.         well" is plenty; don't try to remember "be strong,
  141.         have power, be well," because if you enter "be
  142.         strong, be well," you'll be counted wrong.  The
  143.         program is exceedingly literal-minded.
  144.  
  145.  
  146.     4.  List Mistakes...
  147.  
  148.         You will be asked whether you want to list your
  149.         mistakes to the screen only, or also to the printer.
  150.         These options show you the words you got wrong, both
  151.         the English and the foreign language.  This too is a
  152.         good way to review your weaknesses.
  153.  
  154.  
  155.     5.  Glossary.
  156.  
  157.         This is a quickie dictionary that searches the
  158.         entire .VOC file, both the English and foreign
  159.         words, for any word or pattern of letters you enter.
  160.         You get brief definitions for all matches.
  161.  
  162.  
  163.     6.  Accent Checking.
  164.  
  165.         The program assumes you want to be marked wrong if
  166.         you forget an accent mark or ligature (such as æ):
  167.         this is strict accent checking.  If, for instance,
  168.         the program is expecting "être" and you enter
  169.         "etre," with strict accent checking you'll be marked
  170.         wrong.  (See below for special characters.)
  171.  
  172.         If you want the program to be more lenient, turn
  173.         strict accent checking off.
  174.  
  175.  
  176.  
  177. SPECIAL CHARACTERS
  178. ------------------
  179.  
  180. Since many foreign languages require special characters, the
  181. Vocabulary Tutor is designed to allow consistent and easy
  182. entry of characters with diacritical marks.  The keystrokes
  183. required are as follows:
  184.  
  185.     VOWELS
  186.  
  187.         Pressing ` after a vowel produces that vowel with a
  188.         grave accent:  i.e., "e" followed by ` produces è.
  189.  
  190.         Pressing ' after a vowel produces that vowel with an
  191.         acute accent:  i.e., "e" followed by ' produces é.
  192.  
  193.         Pressing ^ (shift-6) after a vowel produces that
  194.         vowel with a circumflex:  i.e., "e" followed by ^
  195.         produces ê.
  196.  
  197.         Pressing : or ; after a vowel produces that vowel
  198.         with a diaeresis or umlaut:  i.e., "e" followed by :
  199.         produces ë.
  200.  
  201.         Pressing Alt at the same time as any vowel also
  202.         produces an acute accent:  Alt-E produces é.
  203.  
  204.         Pressing Ctrl at the same time as any vowel also
  205.         produces a circumflex:  Ctrl-E produces ê.
  206.  
  207.         The @ produces the ae ligature, æ.
  208.  
  209.  
  210.     CONSONANTS
  211.  
  212.         Alt-N produces ñ.
  213.         Alt-C produces ç.
  214.         Alt-S produces ß.
  215.  
  216.  
  217.  
  218. THE .VOC FILE
  219. -------------
  220.  
  221. The vocabulary .VOC file contains all the information the
  222. program uses in the vocabulary drills.  The format of the
  223. file -- plain ASCII -- is as follows:
  224.  
  225.     The first line contains the name of the language, e.g.,
  226.     Latin.  The program uses this information in the menu.
  227.  
  228.     The remaining lines contain the vocabulary data, with
  229.     each word taking up four lines of no more than 40
  230.     characters each.  The first of these four lines is the
  231.     foreign word; the second, the English translation; the
  232.     third, a chapter number (or 0 if the word is not
  233.     associated with a chapter); and the fourth, a category
  234.     number.  This last feature is not yet implemented.  When
  235.     it is, it will be possible to limit the quiz to certain
  236.     classes of verbs, for instance, or to words about
  237.     certain topics.
  238.  
  239. A typical file might begin like this:
  240.  
  241.     Latin                           <-- First line, name of the language.
  242.     a, ab + abl.                    <-- Foreign word number 1.
  243.     from, by                        <-- English definition.
  244.     18                              <-- Chapter.
  245.     0                               <-- Category (always zero).
  246.     abeo, abire, abii, abitum       <-- Foreign word number 2.
  247.     to go away, to leave, go from   <-- English definition.
  248.     37                              <-- Chapter.
  249.     0                               <-- Category.
  250.  
  251. Important:  there can be no blank lines after the last line
  252. of the file.  There can be up to 1,000 words -- 4,001 lines
  253. -- in the .VOC file.
  254.  
  255. Try to make the definitions as tolerant of mistakes as
  256. possible.  In an English definition, for instance, include
  257. as many synonums as the forty-character limit will allow.
  258. This way a user who knows an English definition for a word
  259. is more likely to get a correct match.  Try to choose the
  260. most obvious definitions.
  261.  
  262.  
  263. PARTS OF SPEECH QUIZZES
  264. -----------------------
  265.  
  266. The program isn't limited to simple vocabulary quizzing; the
  267. enclosed file VERBS.VOC includes drilling on conjugated
  268. Latin verbs, for instance.  In this case, an English to
  269. Latin quiz might ask
  270.  
  271.     duco, 3s future perfect ind active,
  272.  
  273. to which the answer would be the Latin
  274.  
  275.     duxerit.
  276.  
  277. The quiz can also go from Latin to English, requiring you
  278. to parse the verb.
  279.  
  280. For parsing, it's important to follow the exact format of
  281. the definition:
  282.  
  283.     First is the first principle part of the verb, e.g.,
  284.     amo, duco.  This is followed by a comma and a space.
  285.  
  286.     Next is the person, 1, 2, or 3, and the number, s or p.
  287.     1s is first-person singular; 2p is second-person plural.
  288.     Followed by a space.
  289.  
  290.     Next is the tense, always spelled out:  present,
  291.     imperfect, future, perfect, pluperfect, or future
  292.     perfect.  Another space.
  293.  
  294.     Next is the mood, abbreviated to ind (indicative) or
  295.     subj (subjunctive).  Another space.
  296.  
  297.     Last is the voice, spelled out:  active or passive.
  298.  
  299. Some examples:
  300.  
  301.     duco, 2p future perfect ind active
  302.     amo, 1s imperfect ind passive.
  303.  
  304. This system is both relatively intuitive and allows you to
  305. enter only the information you want to be quizzed on:  since
  306. the program checks only to see whether your entry is
  307. contained in the foreign phrase, it's possible to parse
  308. "duxerit" as simply "3s future perfect," or "future perfect
  309. ind active," or "3s," or even just "duco."
  310.  
  311. It may take some getting used to, but I hope this system is
  312. clear, intuitive, and requires as little typing as possible.
  313.  
  314.  
  315. POSSIBLE ENHANCEMENTS
  316. ---------------------
  317.  
  318. The following are possibilities for future releases:
  319.  
  320.     *   Simple help screens to describe program functions.
  321.  
  322.     *   Hints for difficult vocabulary words:  perhaps the
  323.         program could display English cognates.  So, for
  324.         instance, if a user can't remember that the
  325.         definition of the Latin word "lego" is "read," the
  326.         program could give hints such as "legible."
  327.  
  328.     *   Extra help when the user gets a question wrong.  Now
  329.         the program displays the correct answer.  Perhaps it
  330.         could also check to see if the user was thinking of
  331.         another word:  so, for instance, if the user defines
  332.         "lego" as "tie," the program could respond with
  333.         something like, "No; lego means to read.  Ligo is
  334.         the word for tie."
  335.  
  336.     *   Timed quizzes are a possibility.
  337.  
  338.     *   Implementation of the word categories feature.  This
  339.         way it will be possible to select (for instance) all
  340.         deponent verbs, or all colloquial idioms, or
  341.         whatever.
  342.  
  343.     *   Support for non-Roman alphabets, such as Greek and
  344.         Russian.  This would require an EGA or VGA monitor
  345.         and some extra memory, and could significantly swell
  346.         the size of the .VOC files.  Best, probably, would
  347.         be to overwrite the high-ASCII characters with the
  348.         new alphabet.  I'll have to think about this one.
  349.  
  350. Suggestions for improvement can be sent to Jack Lynch; the
  351. address appears on the opening screen.
  352.